home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / progming / beta27 / readme.doc < prev    next >
Text File  |  1993-04-21  |  30KB  |  1,062 lines
  1.        
  2.  
  3.  
  4.  
  5.  
  6.        
  7.        
  8.        
  9.        
  10.        
  11.        
  12.                              BETA TESTERS MANUAL
  13.        
  14.                     <* your software company name here *>
  15.        
  16.        
  17.                             Phone : (###) ###-####
  18.        
  19.        
  20.                               BBS (###) ###-####
  21.        
  22.                           Protocol is 9600, N, 8, 1
  23.                              available 24 hours.
  24.        
  25.        
  26.                               FAX (###) ###-####
  27.        
  28.        
  29.                           ADDRESS : #####################
  30.                                     #####################
  31.                                     #####################
  32.        
  33.        
  34.        <* NOTE: If No Fax Remove Fax Reference On This Page, Contents, 
  35.        And In Manual *>
  36.        
  37.  
  38.        
  39.  
  40.  
  41.  
  42.  
  43.         Overview............................................. 3
  44.        
  45.         Testing.............................................. 4
  46.               Alpha Testing.................................. 4
  47.               Beta Testing................................... 4
  48.               What Beta Testing is Not....................... 4
  49.               Documentation.................................. 5
  50.               Beta Material.................................. 5
  51.        
  52.         Communications....................................... 6
  53.               Phone.......................................... 6
  54.               BBS...........................................  6
  55.               Fax............................................ 6
  56.               Not finding any Problems? (IMPORTANT).......... 6
  57.        
  58.         Using the Beta Report Generator...................... 7
  59.        
  60.         Problem Report Format................................ 9
  61.        
  62.         Using the Bulletin Board............................ 10
  63.               General Information........................... 10
  64.               Uploading Reports............................. 10
  65.               Downloading Files............................. 10
  66.               Bulletin...................................... 10
  67.        
  68.         Beta Evaluation..................................... 11
  69.        
  70.         End of Beta......................................... 12
  71.               On going support.............................. 12
  72.               Beta testing future releases.................. 12
  73.        
  74.         Appendix  1 - Testing Ideas......................... 13
  75.        
  76.         Appendix  2 - Sample: Problem Report................ 14
  77.        
  78.         Appendix  3 - Problem Solving Techniques............ 17
  79.        
  80.         Appendix  4 - Trouble Shooting Tips................. 18
  81.        
  82.  
  83.        
  84.  
  85.  
  86.  
  87.  
  88.                                    OVERVIEW
  89.        
  90.        
  91.        We have designed these beta procedures, to inform you of how to 
  92.        use the BETARPT program. In addition, we will outline the 
  93.        reporting procedures when problems have been found in application 
  94.        software. Our overall goal is to achieve a streamlined method of 
  95.        reporting application bugs and making timely corrections.
  96.        
  97.        We understand the time constraints and pressures that our beta 
  98.        testers are under. We hope that you also realize that we are under 
  99.        timely pressures as well. There will be times when beta tests will 
  100.        be pushed back to a later date or given less testing time. We 
  101.        intend to do our best to prevent this from happening. We want you 
  102.        to enjoy testing our products while providing us with your input.
  103.        
  104.        We will try our best to follow the procedures outlined. As beta 
  105.        testing develops and changes, so will the procedures. We will 
  106.        provide you with updates of the beta report generator and policies 
  107.        manual as appropriate. We will always welcome any ideas that you 
  108.        have that will strengthen the communication's channel. Please 
  109.        contact us if there is something that you do not understand.
  110.        
  111.        Please remember it is a time-consuming task to track all the 
  112.        problems that beta testers report. If we have trouble recreating 
  113.        your reported problem, we may ask you for additional information. 
  114.        The following outlined procedures should keep communications open 
  115.        and all beta testing aspects tied together.
  116.        
  117.        
  118.        
  119.        
  120.        
  121.        
  122.        
  123.        
  124.        
  125.        
  126.        
  127.        
  128.        
  129.        
  130.        
  131.        
  132.        
  133.        
  134.        
  135.        
  136.        
  137.        
  138.        
  139.        
  140.                                       3
  141.  
  142.        
  143.  
  144.  
  145.  
  146.  
  147.                                    TESTING
  148.        
  149.        
  150.        Alpha Testing
  151.        
  152.        The alpha testing phase of the application is done by us using 
  153.        in-house testers before the application goes to outside beta 
  154.        testers. Alpha testing is designed to make sure that all features 
  155.        of the product work with other hardware and software that we have 
  156.        available. 
  157.        
  158.        When all the major problems have been found, we then select beta 
  159.        sites to send the product to for additional testing.
  160.        
  161.        
  162.        Beta Testing
  163.        
  164.        In beta testing we ask the beta testers to use, as closely as 
  165.        possible, the application in real world situations. Because of 
  166.        this approach we have found beta testers provide more variety of 
  167.        testing to catch cosmetic flaws, compatibility problems, and other 
  168.        peculiarities about the application. Beta testers use the software 
  169.        and report anything that is not described by the manual, or seems 
  170.        to function improperly.
  171.        
  172.        Please keep in mind that no beta software is problem-free. If you 
  173.        have important information on your machine that cannot be lost, it 
  174.        is to your advantage to make a backup before testing the product. 
  175.        
  176.        WARNING: BE SURE TO HAVE CURRENT BACKUPS OF YOUR DATA.
  177.        
  178.        
  179.        What Beta Testing is Not
  180.        
  181.        Beta testing is not a phase for redesigning the application. The 
  182.        primary purpose of beta testing is to find problems the way the 
  183.        program presently stands. We are always willing to listen to our 
  184.        customers and will gladly take your comments and suggestions, but 
  185.        please understand, more than likely, unless there is an extreme 
  186.        demand for change, you will not see any suggestions implemented 
  187.        until a future release.
  188.        
  189.        
  190.        
  191.        
  192.        
  193.        
  194.        
  195.        
  196.        
  197.        
  198.        
  199.        
  200.                                       4
  201.  
  202.        
  203.  
  204.  
  205.  
  206.  
  207.        Documentation
  208.        
  209.        While going through the application documentation, please let us 
  210.        know about any inconsistencies that you find when possible. As a 
  211.        guideline, we need to know about flaws in the documentation within 
  212.        two weeks after you download the beta material. We do not want to 
  213.        restrict your comments to this period, but comments need to be 
  214.        processed immediately. All your manual comments or suggestions can 
  215.        be put into one report.
  216.        
  217.        
  218.        Beta Material
  219.        
  220.        Beta test updates are available by calling the BBS. Under extreme 
  221.        cases we may ship beta material to the latest address that you 
  222.        have provided. In most cases only the files with bugs will be 
  223.        available as updates.
  224.        
  225.        
  226.        
  227.        
  228.        
  229.        
  230.        
  231.        
  232.        
  233.        
  234.        
  235.        
  236.        
  237.        
  238.        
  239.        
  240.        
  241.        
  242.        
  243.        
  244.        
  245.        
  246.        
  247.        
  248.        
  249.        
  250.        
  251.        
  252.        
  253.        
  254.        
  255.        
  256.        
  257.        
  258.        
  259.        
  260.        
  261.                                       5
  262.  
  263.        
  264.  
  265.  
  266.  
  267.  
  268.                                 COMMUNICATIONS
  269.        
  270.        
  271.        Phone
  272.        
  273.        We use the BBS almost exclusively for the distribution of beta 
  274.        test software. Previously, we used to take beta reports over the 
  275.        phone, however; it turned out to be less than organized. If you 
  276.        have a problem that needs to be resolved by phone, please leave us 
  277.        a message and we will call you.
  278.        
  279.        
  280.        Bulletin Board
  281.        
  282.        The Bulletin Board is our primary source of communication. The 
  283.        number is listed on the cover of the Beta Tester's manual. The BBS 
  284.        protocol is also listed on the cover of the Beta Tester's manual. 
  285.        Prior to receiving this beta procedures manual you should have 
  286.        selected a user name/ID and password. If this did not occur 
  287.        contact us with your selection.
  288.        
  289.        
  290.        Fax
  291.        
  292.        We have a Fax number for your convenience. Please use this only 
  293.        if there is some kind of problem with the BBS.  The exception is 
  294.        if you have material that is better off being faxed such as manual 
  295.        comments and suggestions. The number is listed on the front page 
  296.        of the manual.
  297.        
  298.        
  299.        Not finding any problems
  300.        
  301.        Sometimes especially in the final stages of the beta test its 
  302.        difficult to find problems. If you feel that you are not finding 
  303.        any problems, refer to Appendix 1. This appendix should give you 
  304.        some basic ideas on finding those difficult problems. If you are 
  305.        still unable to find any problems please contact us by submitting 
  306.        a report and let us know what you did test and the outcome. 
  307.        Keeping in contact with us is how we figure out who will be 
  308.        included in future beta tests.
  309.        
  310.        
  311.        
  312.        
  313.        
  314.        
  315.        
  316.        
  317.        
  318.        
  319.        
  320.        
  321.        
  322.                                       6
  323.  
  324.        
  325.  
  326.  
  327.  
  328.  
  329.                        USING THE BETA REPORT GENERATOR
  330.        
  331.        
  332.        Make a directory called BETA. This is a directory for you to 
  333.        store the beta report program and its report files.
  334.        
  335.        To run the report program type BETARPT at the DOS prompt. Once 
  336.        the program is loaded the main menu will appear allowing you to 
  337.        make your selections. The first time that you run the BETARPT 
  338.        program you will immediately enter the program and user 
  339.        information section. Subsequent accesses to BETARPT will not make 
  340.        you go through these two steps. 
  341.        
  342.        Selections are made by pressing the various highlighted function 
  343.        'F' keys. The following 'F' keys are available:
  344.        
  345.                           F1 -  Help
  346.                           F2 -  Program Information
  347.                           F3 -  Tester Information
  348.                           F4 -  Problem Description
  349.                           F5 -  Corrective Action
  350.                           F6 -  DOS Shell
  351.                           F7 -  Program Recommendation
  352.                           F8 -  Special Developer Info.
  353.                           F9 -  Save Temp Files & Exit
  354.                           F10 - Create Report
  355.        
  356.        By making any one of the above selections you will be transferred 
  357.        to that section. Once transferred a status line is provided to 
  358.        offer simply instructions. Context sensitive help is provided by 
  359.        pressing the 'F1' key anytime.
  360.        
  361.        The information below provides a brief explanation of each of the 
  362.        areas within the BETARPT program.
  363.        
  364.           a. By pressing the 'F2' key you are asked to provide bug 
  365.        information about the application you are presently testing. You 
  366.        are asked to be very specific so we may use this information to 
  367.        attempt to reproduce the bug.
  368.        
  369.           b. The 'F3' key will gain useful information about the system 
  370.        you are using to test the beta application. Please fill out all 
  371.        lines as accurately as possible.
  372.        
  373.           c. To describe the bug problem press 'F4'. Please be in-depth 
  374.        while being brief. 
  375.        
  376.           d. The 'F5' key is used to tell us what actions you took to 
  377.        attempt to correct the noted bug. This includes but is not limited 
  378.        to removing the AUTOEXEC.BAT and CONFIG.SYS files.
  379.        
  380.        
  381.        
  382.        
  383.        
  384.                                       7
  385.  
  386.        
  387.  
  388.  
  389.  
  390.  
  391.           e. A DOS shell is provided by pressing the 'F6' key.
  392.        
  393.           f. The 'F7' is provided so you may included specific 
  394.        recommendations for future releases of the product.
  395.        
  396.           g. In some testing applications the 'F8' will be available to 
  397.        you. If the Special Developer Info. is not available if will be a 
  398.        different color than the rest of the selections. If the 'F8' key 
  399.        is available simply answer all the questions as you did in the 
  400.        Tester Information area and Program Information area.
  401.        
  402.           h. Pressing 'F9' will save all current files and exit to DOS. 
  403.        This is useful when you wish to research a particular bug more 
  404.        thoroughly and do not wish to create a new bug report.
  405.        
  406.        6. To create a report press the 'F10' key. Once you have created 
  407.        a report, the Beta Report program will create a file called 
  408.        BETA.RPT. The BETA.RPT file will contain both the report that you 
  409.        just created and the status of your machine at the time you wrote 
  410.        the report. This is the file that we need to have uploaded to us. 
  411.        Once you have written your second report, the report program will 
  412.        rename your first report to BETA.1. The same situation will happen 
  413.        for your third report, where BETA.RPT will be renamed to BETA.2, 
  414.        etc. The most current report will always be named BETA.RPT.
  415.        
  416.        7. When you upload your reports to the BBS, they must be send as 
  417.        a message to the Sysop or as directed at that time. You will have 
  418.        to upload the BETA.RPT file in ASCII format. 
  419.        
  420.        WARNING : DO NOT COMPRESS YOUR REPORTS IN ANY WAY!! Upload in an 
  421.        ASCII format only to the message base.
  422.        
  423.        
  424.        
  425.        
  426.        
  427.        
  428.        
  429.        
  430.        
  431.        
  432.        
  433.        
  434.        
  435.        
  436.        
  437.        
  438.        
  439.        
  440.        
  441.        
  442.        
  443.        
  444.                                       8
  445.  
  446.        
  447.  
  448.  
  449.  
  450.  
  451.                             PROBLEM REPORT FORMAT
  452.        
  453.        
  454.        The following tid bits of information are what we would like to 
  455.        see in the bug problem reports that you will submit. If you give 
  456.        this type of information when reporting a problem, we should be 
  457.        more than likely to duplicate the error and not have a need to 
  458.        call you.
  459.        
  460.        1. Run the BETARPT.EXE program and fill it out all areas that 
  461.        apply entirely.
  462.        
  463.        2. Describe the problem with a short sentence as complete as 
  464.        possible. Then if applicable give a keystroke description of how 
  465.        to reproduce the problem. See Appendix 2 for an example. Read over 
  466.        your report to be certain it clearly describes the problem, 
  467.        keeping in mind that we will have to recreate what you submitted.
  468.        
  469.        3. In narrowing down the problem refer to the problem-solving 
  470.        techniques listed in Appendix 3. By using these techniques it 
  471.        should help to eliminate possible conflicts that may be created by 
  472.        TSRs or other nonessential drivers or programs while testing the 
  473.        application.
  474.        
  475.        
  476.        
  477.        
  478.        
  479.        
  480.        
  481.        
  482.        
  483.        
  484.        
  485.        
  486.        
  487.        
  488.        
  489.        
  490.        
  491.        
  492.        
  493.        
  494.        
  495.        
  496.        
  497.        
  498.        
  499.        
  500.        
  501.        
  502.        
  503.        
  504.        
  505.                                       9
  506.  
  507.        
  508.  
  509.  
  510.  
  511.  
  512.                            USING THE BULLETIN BOARD
  513.        
  514.        
  515.        General Information
  516.        
  517.        The bulletin board is used as the main method of information 
  518.        exchange between us and the beta tester. We ask that you check the 
  519.        bulletin board regularly for any new information regarding 
  520.        upcoming beta tests, or information on current tests.
  521.        
  522.        
  523.        Uploading Reports
  524.        
  525.        The beta report upload is simple and we require ALL reports to be 
  526.        submitted to the message base in ASCII format. Any attempt to 
  527.        compress the files will result in loss of important bug 
  528.        information.
  529.        
  530.        
  531.        Downloading Files
  532.        
  533.        Generally, the BBS only maintains applications presently being 
  534.        tested or individual files of maintenance releases. When a new 
  535.        file is available for downloading you will be advised of this via 
  536.        your message box. Please download the file(s) immediately and 
  537.        delete the message.
  538.        
  539.        
  540.        Bulletin
  541.        
  542.        On the BBS we have a bulletin that is updated weekly, unless 
  543.        there is no new information. Please read it occasionally as it 
  544.        contains important information concerning the status of beta 
  545.        testing.
  546.        
  547.        
  548.        
  549.        
  550.        
  551.        
  552.        
  553.        
  554.        
  555.        
  556.        
  557.        
  558.        
  559.        
  560.        
  561.        
  562.        
  563.        
  564.        
  565.        
  566.                                       10
  567.  
  568.        
  569.  
  570.  
  571.  
  572.  
  573.                                BETA EVALUATION
  574.        
  575.        
  576.        During the beta test period, we will be evaluating each tester 
  577.        based on their participation! If we do not hear from you during 
  578.        the beta test, you will then be withdrawn from future beta 
  579.        testing. If you had indicated a preference for testing other 
  580.        products your name will be removed from those list as well. The 
  581.        point is please keep in communication with us at all time. It is a 
  582.        challenge to manage a beta test and we ask for your support.
  583.        
  584.        
  585.        
  586.        
  587.        
  588.        
  589.        
  590.        
  591.        
  592.        
  593.        
  594.        
  595.        
  596.        
  597.        
  598.        
  599.        
  600.        
  601.        
  602.        
  603.        
  604.        
  605.        
  606.        
  607.        
  608.        
  609.        
  610.        
  611.        
  612.        
  613.        
  614.        
  615.        
  616.        
  617.        
  618.        
  619.        
  620.        
  621.        
  622.        
  623.        
  624.        
  625.        
  626.        
  627.                                       11
  628.  
  629.        
  630.  
  631.  
  632.  
  633.  
  634.                                  END OF BETA
  635.        
  636.        
  637.        Beta testers who successfully complete the beta test will, if 
  638.        possible, receive the final product. Additionally, they will be 
  639.        notified of the testing conclusion that will generally be posted 
  640.        on the BBS for a couple of weeks. We consider successful 
  641.        completion of the beta test means that the tester has found at 
  642.        least 2 or 3 bugs a week and was active throughout the beta 
  643.        period.
  644.        
  645.        
  646.        On going support
  647.        
  648.        After the beta period has ended, all questions can be directed to 
  649.        the Technical Support Department.
  650.        
  651.        
  652.        Beta testing future releases
  653.        
  654.        We will always be looking for future testers because the software 
  655.        will constantly be revised and upgraded to meet our users' 
  656.        demands. Beta testers who are active in finding problems, give 
  657.        clear, concise reports and follow these procedures will be given 
  658.        the opportunity to test future releases.
  659.        
  660.        
  661.        
  662.        
  663.        
  664.        
  665.        
  666.        
  667.        
  668.        
  669.        
  670.        
  671.        
  672.        
  673.        
  674.        
  675.        
  676.        
  677.        
  678.        
  679.        
  680.        
  681.        
  682.        
  683.        
  684.        
  685.        
  686.        
  687.        
  688.                                       12
  689.  
  690.        
  691.  
  692.  
  693.  
  694.  
  695.        APPENDIX 1
  696.        
  697.        
  698.                                 Testing Ideas
  699.        
  700.        
  701.        
  702.        1. Test the interface-checking of each button, Function keys, 
  703.        Quick keys, menu selections, and mouse functionality. 
  704.        
  705.        2. Test the on-line and manual help. Refer to the beta 
  706.        applications README file or manual for where to go to get help 
  707.        information.
  708.        
  709.        3. Verify all program parameters or command line options.
  710.        
  711.        4. Read the manual and test the described functionality.
  712.        
  713.        5. Test the different configuration options.
  714.        
  715.        6. Review the beta manual for errors and inconsistencies with the 
  716.        program.
  717.        
  718.        7. If possible, use the program in your everyday environment.
  719.        
  720.        
  721.        
  722.        
  723.        
  724.        
  725.        
  726.        
  727.        
  728.        
  729.        
  730.        
  731.        
  732.        
  733.        
  734.        
  735.        
  736.        
  737.        
  738.        
  739.        
  740.        
  741.        
  742.        
  743.        
  744.        
  745.        
  746.        
  747.        
  748.        
  749.        
  750.                                       13
  751.  
  752.        
  753.  
  754.  
  755.  
  756.  
  757.        APPENDIX 2
  758.        
  759.                             Sample Problem Report
  760.        
  761.        
  762.        
  763.        
  764.        
  765.        
  766.        
  767.                                     BETA TEST REPORT
  768.                                     MyLife Software
  769.                        Report Created : 12-22-1992   Time : 22:51:52
  770.                        Report Submission Number: 4
  771.        
  772.        ----- TESTER INFORMATION: -----
  773.        
  774.        Name :                 John Sanders                            
  775.        Address :              704 Rim Drive                          
  776.        City, State, and Zip : Killeen, Tx  76542                      
  777.        Home Phone :           (817)634-8569
  778.        Home Phone Can Call :  X
  779.        Work Phone :           (817)634-3043
  780.        Work Phone Can Call :   
  781.        Fax Phone :            (817)628-2017
  782.        System Type :      80386  
  783.        System Make :      Genesis
  784.        System BIOS :      AMI                 
  785.        System BIOS Date : 09/10/90 System Memory :    8   meg
  786.        System Memory Manager : Qemm v6.01
  787.        'A' Floppy Drive Size : 5.25HD 
  788.        'B' Floppy Drive Size : 3.5 HD 
  789.        Harddrive Size : 210  meg
  790.        Harddrive Type : Seagate, IDE
  791.        Monitor Type :   SVGA     
  792.        Monitor Maker :  Ultra VGA 
  793.        Monitor Card Maker : Ultra, 1Meg
  794.        Operating System :   DOS V5.0  
  795.        File Compression :   Stacker v2.0 with card
  796.        Modem :   X  Modem Type : Mx Modem, 2400 Baud
  797.        Mouse :   X  Mouse Type : Prohance, Tracball
  798.        Fax :        Fax Type :
  799.        Scanner : X  Scanner Type : The Complete, B&W Scanner
  800.        Other :   X  Other Type : Arcnet Card
  801.        
  802.        ----- PROGRAM INFORMATION: -----
  803.        
  804.        Application Name :  Decide, V2.0 
  805.        Program Name :      DECIDE  .EXE
  806.        
  807.        
  808.        
  809.        
  810.        
  811.                                       14
  812.  
  813.        
  814.  
  815.  
  816.  
  817.  
  818.        Program File Size : 64325      bytes 
  819.        Program File Creation Date : 10/02/92 
  820.        Program File Creation Time : 12:34
  821.        Tried Without AUTOEXEC.BAT : X 
  822.        Tried Without CONFIG.SYS :   X 
  823.        Occurs in Windows :          X 
  824.        Occurs in OS/2 :             
  825.        Occurs :                     Sometimes    
  826.        General Bug Description :
  827.        The mouse does not function properly.
  828.        
  829.        ----- PROBLEM DESCRIPTION: -----
  830.        
  831.        When accessing certain menu areas the mouse will disappear. I 
  832.        access a different menu area and return to the main menu and the 
  833.        mouse will not appear. I have to exit the program in order to get 
  834.        the mouse to reappear.
  835.        
  836.        ----- CORRECTIVE ACTION: -----
  837.        
  838.        I tried removing the Tracball driver and tried several other 
  839.        drivers. I also attempted to use a Microsoft compatible mouse.
  840.        
  841.        ----- APPLICATION RECOMMENDATION: -----
  842.        
  843.        ----- AUTOEXEC.BAT file: -----
  844.        
  845.        SET COMSPEC=C:\DOS\COMMAND.COM C:\QEMM\LOADHI /R:1 
  846.        C:\DOS\APPEND=C:\DOS COPY C:\DOS\COMMAND.COM C:\>NUL
  847.        PROMPT $e[1;44;37m*$e[0m$e[41m▀▀▀$e[0m $p$g C:\QEMM\LOADHI /R:1 
  848.        C:\QEMM\BUFFERS=50 C:\QEMM\LOADHI /R:1 C:\DOS\EMMOUSE 
  849.        C:\QEMM\LOADHI /R:1 C:\DOS\MOUSE
  850.        SET PCTOOLS=D:\PCTOOLS\DATA
  851.        SET TEMP=C:\WINDOWS\TEMP
  852.        SET LIB=D:\BC7\LIB
  853.        SET OBJ=D:\PROBAS\OBJ
  854.        SET GMKW=D:\GMKW\
  855.        SET COMMUTE=D:\COMMUTE\DATA
  856.        PATH=C:\QEMM;C:\DOS;C:\WINDOWS;C:\STACKER;D:\GMKW;D;\CALERA\BIN 
  857.        MIRROR C: D: E:
  858.        
  859.        ----- CONFIG.SYS file: -----
  860.        
  861.        DEVICE=C:\QEMM\QEMM386.SYS R:1 EXCLUDE=B000-BA00 RAM ST:M
  862.        DOS = HIGH
  863.        SHELL=C:\DOS\COMMAND.COM C:\ /E:512 /P 
  864.        DEVICE=c:\qemm\loadhi.sys /r:1 c:\dos\ansi.sys 
  865.        DEVICE=c:\qemm\loadhi.sys /r:1 c:\dos\setver.exe
  866.        FILES = 50
  867.        
  868.        
  869.        
  870.        
  871.        
  872.                                       15
  873.  
  874.        
  875.  
  876.  
  877.  
  878.  
  879.        BUFFERS = 1
  880.        DEVICE=C:\QEMM\LOADHI.SYS /R:1 D:\CALERA\CPCSCAN.SYS 3e0 2 1 
  881.        DEVICE=C:\QEMM\LOADHI.SYS /R:1 C:\STACKER\STACKER.COM 
  882.        C:\STACVOL.000
  883.        
  884.        
  885.        ------------------------ END OF REPORT ------------------------
  886.        
  887.        
  888.        This is an example of a simple problem report. We realize that 
  889.        some problems you may encounter will need to be narrowed down, but 
  890.        since we have a good step-by-step description we also should be 
  891.        able to recreate it.
  892.        
  893.        Any information you provide about the problem will be very 
  894.        helpful. If the example information is supplied, there should be 
  895.        no cause for more information, unless we simply cannot recreate 
  896.        the described situation.
  897.        
  898.        Keep a copy of your reports for testing updated versions of the 
  899.        product.
  900.        
  901.        
  902.        
  903.        
  904.        
  905.        
  906.        
  907.        
  908.        
  909.        
  910.        
  911.        
  912.        
  913.        
  914.        
  915.        
  916.        
  917.        
  918.        
  919.        
  920.        
  921.        
  922.        
  923.        
  924.        
  925.        
  926.        
  927.        
  928.        
  929.        
  930.        
  931.        
  932.        
  933.                                       16
  934.  
  935.        
  936.  
  937.  
  938.  
  939.  
  940.        APPENDIX 3
  941.        
  942.        
  943.                           Problem Solving Techniques
  944.        
  945.        
  946.        To narrow down a problem you will need to troubleshoot it. Here 
  947.        are a few suggestions to get you started.
  948.        
  949.        
  950.        1. Can the problem be duplicated consistently?
  951.        
  952.        2. Are you running with any memory resident(TSR's) programs? If 
  953.        so, try running without them. Does the problem still exist?
  954.        
  955.        3. Try rebooting your machine without the AUTOEXEC.BAT and 
  956.        CONFIG.SYS. Does the problem go away? If yes, use a process of 
  957.        elimination to find the compatibility problem. (Add CONFIG.SYS and 
  958.        test, then add AUTOEXEC.BAT and test, etc.)
  959.        
  960.        4. If the application is small enough try using it on another 
  961.        computer. Does the problem occur on another computer? If not, what 
  962.        is the DOS and BIOS version and date of the problem computer?
  963.        
  964.        5. Do you have all the necessary files to run the program? Try 
  965.        reinstalling the program and retest it again.
  966.        
  967.        6. Did the bug occur in an earlier beta version?
  968.        
  969.        7. Could the files be sitting on a bad sector? Copy all program 
  970.        files to another subdirectory and try again.
  971.        
  972.        
  973.        These are merely suggestions to help in the debugging process. 
  974.        If, after trying these suggestions you are still not sure what to 
  975.        do, let us know what you have tried and what the outcome was. Once 
  976.        in while you may find a problem that occurs very infrequently, go 
  977.        ahead and report it. If several people report the same thing we 
  978.        may be able to find a pattern.
  979.        
  980.        
  981.        
  982.        
  983.        
  984.        
  985.        
  986.        
  987.        
  988.        
  989.        
  990.        
  991.        
  992.        
  993.                                       17
  994.  
  995.        
  996.  
  997.  
  998.  
  999.  
  1000.        APPENDIX 4
  1001.        
  1002.        
  1003.                             Trouble Shooting Tips
  1004.        
  1005.        
  1006.        Listed below are several items that may help you in trouble 
  1007.        shooting problems with our beta applications:
  1008.        
  1009.           a. Boot from the 'A' drive and a clean system. If the problem 
  1010.        does not exist then use the process of elimination to determine 
  1011.        the cause.
  1012.        
  1013.           b. Check for multiple copies or versions of 'COMMAND.COM' on 
  1014.        your drive(s). Remove any that are not used.
  1015.        
  1016.           c. Reinstall the application on/in a different subdirectory or 
  1017.        drive. If the application works correctly then old files are 
  1018.        either corrupt or the files were sitting on a bad sector of the 
  1019.        disk.
  1020.        
  1021.           d. Use all command line options.
  1022.        
  1023.           e. Change the selected video mode.
  1024.        
  1025.           f. Ensure all cables are correctly secured.
  1026.        
  1027.           g. Ensure all computer circuit cards are correctly installed.
  1028.        
  1029.           h. Check all memory chips.
  1030.        
  1031.           i. Check for interrupt conflicts. It is possible that 2 or 
  1032.        more boards or ports are occupying the same interrupt.
  1033.        
  1034.           j.  Check that the interrupts you are using are set correctly 
  1035.        for the device. Make such LPT1 is using IRQ 7, Comm 1 is using IRQ 
  1036.        4 and Comm 2 is using IRQ 3.
  1037.        
  1038.           k. Use the DOS program CHKDSK.exe to check the condition of 
  1039.        the harddrive. It is possible you have lost clusters or a 
  1040.        corrupted file allocation table.
  1041.        
  1042.           l. If you have a conflict with a memory manager such as QEMM 
  1043.        or 386MAX try using command line options that control upper, 
  1044.        expanded, and extended memory.
  1045.        
  1046.           m. Make sure that no memory conflicts exist. Some LAN cards 
  1047.        require upper memory that is mapped by a memory manager.
  1048.        
  1049.        
  1050.        
  1051.        
  1052.        
  1053.        
  1054.        
  1055.                                       18
  1056.  
  1057.        
  1058.  
  1059.  
  1060.  
  1061.  
  1062.